home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / evalti.zip / EVALTIME.DOC next >
Text File  |  1994-01-01  |  3KB  |  100 lines
  1. ================================================================================
  2. Copyright (c) 1994  Christopher A. Zielinski
  3. ================================================================================
  4.  
  5.  
  6. Christopher A. Zielinski,  (CIS: 72723,2701)
  7. (416) 767-9674  9am-5pm  EST  voice/fax
  8. 94.01.01
  9.  
  10.  
  11. TimeEval() is an event-driven, Clipper 5.2c function that will evaluate a
  12. Clipper code block every nth seconds.  Note, the computers interal clock
  13. provides the event of time changing.
  14.  
  15.  
  16. Copyright & Disclaimer
  17. ======================
  18.  
  19. This package is Copyrighted (c) 1994, however, permission is granted for use
  20. in any finished program, commercial or otherwise.  Permission is not granted
  21. to include these routines in third party commercial or shareware LIBRARIES.
  22.  
  23. Use of the information, source code, and library are strictly at the risk of
  24. the user, and the author will not be responsible for any damage incurred,
  25. either from direct use or otherwise.
  26.  
  27.  
  28.  
  29. Acknowledgments
  30. ===============
  31.  
  32. Rick Spence, who has been a great teacher, especially with those little
  33. glitches in his examples that force you to understand the material taught.  In
  34. particular, his article "Understanding the item API" in Clipper Advisor --
  35. January/February 1994, which assisted in calling Clipper from C.
  36.  
  37. Brenton Farmer, (CIS: 71621,627) who inspired the whole thing.  Although his
  38. original work did not function properly -- it was a very good attempt and
  39. provided a good concept to work from.
  40.  
  41. Computer Associates, who gave us Clipper 5.2c that provided a legitimate way of
  42. calling Clipper from C, (no need to poke around with undocumented internal
  43. functions).  And a special thanks to David Lyon, who pointed out that printf()
  44. allocates memory.
  45.  
  46. Hackers, who document the undocumented.
  47.  
  48. CIBC, who gave me my first programming job and introduced me to Clipper.
  49.  
  50.  
  51. Usage
  52. =====
  53.  
  54.  
  55. 1.      Never overlay EvalTime.LIB or the ISR_Routine module in EvalTime.LIB!
  56.         Note, the standard RTLink supplied with Clipper 5.2c cannot overlay
  57.         these.
  58.  
  59.  
  60. 2.    Clipper syntax of TimeEval:
  61.  
  62.     TimeEval( nEveryNthSec, cCodeBlockAsString ) --> NIL
  63.  
  64.         This is the only procedure to be called by the developer.  Note, the
  65.         code block will not be evaluated while the Clipper error system has
  66.         control.
  67.  
  68.         Called with more/less parameters, removes TimeEval() from system.
  69.  
  70.             nEveryNthSec       --> is how often cCodeBlockAsString is evaluated
  71.                                    in terms of seconds.
  72.  
  73.             cCodeBlockAsString --> is a string representation of a complete
  74.                                    code block expression.  Note, the return
  75.                                    value of the code block will be lost.
  76.  
  77.         Example:
  78.  
  79.             PROCEDURE Main()
  80.  
  81.                 REQUEST QOUT
  82.                 CLS
  83.  
  84.                 // Install time evaluater
  85.                 TimeEval( 1, "{ || QOUT( TIME() ) }" )
  86.  
  87.                 // Wait
  88.                 Inkey( 0 )
  89.  
  90.                 // Remove time evaluater
  91.                 TimeEval()
  92.  
  93.                 RETURN
  94.  
  95.  
  96. 3.      Review the source code if you plan on altering Clipper 5.2c's standard
  97.         error handling system while TimeEval() is installed.
  98.  
  99.  
  100.